<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>FTP Class : CodeIgniter User Guide</title>

<style type='text/css' media='all'>@import url('../userguide.css');</style>
<link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />

<script type="text/javascript" src="../nav/nav.js"></script>
<script type="text/javascript" src="../nav/prototype.lite.js"></script>
<script type="text/javascript" src="../nav/moo.fx.js"></script>
<script type="text/javascript" src="../nav/user_guide_menu.js"></script>

<meta http-equiv='expires' content='-1' />
<meta http-equiv= 'pragma' content='no-cache' />
<meta name='robots' content='all' />
<meta name='author' content='ExpressionEngine Dev Team' />
<meta name='description' content='CodeIgniter User Guide' />

</head>
<body>

<!-- START NAVIGATION -->
<div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker_th.jpg" width="154" height="43" border="0" title="Toggle Table of Contents" alt="Toggle Table of Contents" /></a></div>
<div id="masthead">
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td><h1>คู่มือการใช้งาน CodeIgniter เวอร์ชั่น 1.7.2</h1></td>
<td id="breadcrumb_right"><a href="../toc.html">หน้าตารางเนื้อหา</a></td>
</tr>
</table>
</div>
<!-- END NAVIGATION -->


<!-- START BREADCRUMB -->
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td id="breadcrumb">
<a href="http://codeigniter.in.th/">CodeIgniter.in.th</a> &nbsp;&#8250;&nbsp;
<a href="../index.html">หน้าหลักคู่มือการใช้งาน</a> &nbsp;&#8250;&nbsp;
FTP Class
</td>
<td id="searchbox"><form method="get" action="http://www.google.com/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.in.th/user_guide/" />ค้นหาคู่มือการใช้งาน&nbsp; <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />&nbsp;<input type="submit" class="submit" name="sa" value="ค้นหา" /></form></td>
</tr>
</table>
<!-- END BREADCRUMB -->

<br clear="all" />


<!-- START CONTENT -->
<div id="content">


<h1>FTP Class</h1>

<p>คลาส FTP ของ CodeIgniter ยอมให้คุณจัดการไฟล์เซิร์ฟเวอร์ทางไกลได้ ไฟล์ทางไกลสามารถย้าย , เปลี่ยนชื่อ,
และลบ  คลาส FTP ยังมีฟังก์ชัน "mirroring" ที่ทำให้ไดเรคทอรี่ในเครื่องถูกสร้างให้เหมือนกันใน FTP ทางไกลได้</p>

<p class="important"><strong>Note:</strong>&nbsp; SFTP and SSL FTP protocols are not supported, only standard FTP.</p>

<h2>เริ่มต้นใช้คลาส</h2>

<p>เหมือนคลาสอื่นๆของ CodeIgniter คลาส FTP
นั้นเริ่มต้นได้ในตัวบควมคุม(controller) โดยใช้ฟังก์ชัน <dfn>$this-&gt;load-&gt;library</dfn></p>

<code>$this->load->library('ftp');</code>
<p>เมื่อโหลดแล้วคุณสามารถใช้ออบเจ็ค FTP ได้โดยการใช้ <dfn>$this-&gt;ftp</dfn></p>


<h2>ตัวอย่างการใช้งาน</h2>

<p>ในตัวอย่างนี้จะเปิดเซิร์ฟเวอร์ FTP และอ่านไฟล์ในเครื่องแล้วอัพโหลดในรูปแบบ ASCII  และตั้งค่ายินยอมของไฟล์ไปที่ 755  ข้อควรจำ: การเปลี่ยนค่ายินยอมจำเป็นต้องใช้ PHP 5</p>

<code>
$this->load->library('ftp');<br />
<br />
$config['hostname'] = 'ftp.example.com';<br />
$config['username'] = 'your-username';<br />
$config['password'] = 'your-password';<br />
$config['debug'] 	= TRUE;<br />
<br />
$this->ftp->connect($config);<br />
<br />
$this->ftp->upload('/local/path/to/myfile.html', '/public_html/myfile.html', 'ascii', 0775);<br />
<br />
$this->ftp->close();

</code>


<p>ในตัวอย่างนี้เป็นการแสดงไฟล์ที่ได้รับมาจากทางฝั่งเซิร์ฟเวอร์</p>

<code>
$this->load->library('ftp');<br />
<br />
$config['hostname'] = 'ftp.example.com';<br />
$config['username'] = 'your-username';<br />
$config['password'] = 'your-password';<br />
$config['debug'] 	= TRUE;<br />
<br />
$this->ftp->connect($config);<br />
<br />
$list = $this->ftp->list_files('/public_html/');<br />
<br />
print_r($list);<br />
<br />
$this->ftp->close();
</code>

<p>ในตัวอย่างนี้คือไดเรคทอรี่ในเครื่องถูกสร้างให้เหมือนบนเซิร์ฟเวอร์</p>


<code>
$this->load->library('ftp');<br />
<br />
$config['hostname'] = 'ftp.example.com';<br />
$config['username'] = 'your-username';<br />
$config['password'] = 'your-password';<br />
$config['debug'] 	= TRUE;<br />
<br />
$this->ftp->connect($config);<br />
<br />
$this->ftp->mirror('/path/to/myfolder/', '/public_html/myfolder/');<br />
<br />
$this->ftp->close();
</code>


<h1>ฟังก์ชันอ้างอิง</h1>

<h2>$this->ftp->connect()</h2>

<p>ติดต่อและบันทึกข้อมูลเวลาติดต่อไปยังเซิร์ฟเวอร์ FTP การปรับแต่งการเชื่อมต่อนั้นสามารถทำได้โดยการใส่อาเรย์ไปยังฟังก์ชัน หรือคุณสามารถเก็บมันไว้ในไฟล์ปรับแต่งได้</p>


<p>นี้คือตัวอย่างที่แสดงการตั้งค่าด้วยตนเอง</p>

<code>
$this->load->library('ftp');<br />
<br />
$config['hostname'] = 'ftp.example.com';<br />
$config['username'] = 'your-username';<br />
$config['password'] = 'your-password';<br />
$config['port']&nbsp;&nbsp;&nbsp;&nbsp; = 21;<br />
$config['passive']&nbsp;&nbsp;= FALSE;<br />
$config['debug']&nbsp;&nbsp;&nbsp;&nbsp;= TRUE;<br />
<br />
$this->ftp->connect($config);<br />
</code>

<h3>ตั้งค่าปรับแต่ง FTP ในไฟล์ปรับแต่ง</h3>

<p>ถ้าคุณต้องการที่จะเก็บค่าปรับแต่งไว้ในไฟล์ปรับแต่ง
ทำได้ง่ายๆโดยสร้างไฟล์ที่ชื่อ <var>ftp.php</var> และใส่อาเรย์ตัวแปร <var>$config</var>
ลงไปในไฟล์นั้น จากนั้นบันทึกเป็นไฟล์แล้วนำไปวางไว้ที่ <var>config/ftp.php</var> และมันจะถูกใช้อย่างอัตโนมัติ</p>

<h3>ค่าปรับการเชื่อมต่อที่สามารถใช้ได้</h3>


<ul>
<li><strong>hostname</strong> - ชื่อโฮส FTP โดยปกติแล้วจะเป็นประมาณนี้ <dfn>ftp.example.com</dfn></li>
<li><strong>username</strong> - ชื่อผู้ใช้งานของ FTP</li>
<li><strong>password</strong> - รหัสผ่านของ FTP</li>
<li><strong>port</strong> - ตัวเลขพอร์ต (port) โดยปกติจะถูกตั้งเป็น <dfn>21</dfn></li>
<li><strong>debug</strong> - <kbd>TRUE/FALSE</kbd> (boolean). ถ้าเปิด debug มันจะแสดงข้อมูลที่ผิดพลาดผ่านทางไฟล์บันทึก (log)</li>
<li><strong>passive</strong> - <kbd>TRUE/FALSE</kbd> (boolean). สามารถเปิดเป็นโหมดแบบเฉื่อย (passive) โดยทั่วไปนั้นโหมดเฉื่อยนั้นจะถูกตั้งค่าอย่างอัตโนมัติ</li>
</ul>



<h2>$this->ftp->upload()</h2>

<p>อัพโหลดไฟล์ขึ้นไปยังเซิร์ฟเวอร์  คุณต้องใส่ตำแหน่งไฟล์ในเครื่อง(local path) และตำแหน่งไฟล์ทางไกล(remote path) และคุณยังสามารถตั้งโหมดและค่ายินยอม (permission) ตัวอย่างเช่น</p>


<code>$this->ftp->upload('/local/path/to/myfile.html', '/public_html/myfile.html', 'ascii', 0775);</code>

<p><strong>ทางเลือกโหมดมีดังนี้:</strong>&nbsp; <kbd>ascii</kbd>, <kbd>binary</kbd>, และ <kbd>auto</kbd> (ค่าตั้งต้น). ถ้า
<kbd>auto</kbd> ถูกใช้มันจะตั้งโหมดตามนามสกุลไฟล์ของไฟล์ต้นฉบับ</p>

<p>การตั้งค่าการยินยอมสามารถใช้ได้เฉพาะถ้าคุณใช้ PHP 5 และสามารถส่งค่าเป็น <kbd>octal</kbd> (เลขฐานแปด) ในพารามิเตอร์ที่สี่</p>


<h2>$this->ftp->rename()</h2>
<p>ยอมให้คุณเปลี่ยนชื่อไฟล์  โดยให้ใส่ตำแหน่งชื่อไฟล์ และตำแหน่งชื่อไฟล์ใหม่</p>

<code>
// เปลี่ยนจาก green.html เป็น blue.html<br />
$this->ftp->rename('/public_html/foo/green.html', '/public_html/foo/blue.html');
</code>

<h2>$this->ftp->move()</h2>
<p>ให้คุยย้ายไฟล์  โดยใส่แหล่งตั้งต้นแล้วก็ปลายทางที่ต้องการ</p>

<code>
// ย้าย blog.html จาก "joe" ไป "fred"<br />
$this->ftp->move('/public_html/joe/blog.html', '/public_html/fred/blog.html');
</code>

<p>ข้อสังเกตุ: ถ้าปลายทางของไฟล์ชื่อเปลี่ยนไปมันก็จะเปลี่ยนชื่อไฟล์ด้วย</p>


<h2>$this->ftp->delete_file()</h2>
<p>ให้คุณลบไฟล์โดยใส่ตำแหน่งของไฟล์</p>

<code>
$this->ftp->delete_file('/public_html/joe/blog.html');
</code>


<h2>$this->ftp->delete_dir()</h2>
<p>ยอมให้คุณลบไดเรคทอรี่และทุกอย่างที่อยู่ภายในมัน  โดยใส่ตำแหน่งของไดเรคทอรี่และจบด้วย / (trailing slash)</p>

<p class="important"><strong>สิ่งสำคัญ</strong>&nbsp; จะต้องระมัดระวังในการใช้ฟังก์ชันนี้  มันจะลบ 
<b>ทุกอย่าง</b> ภายในตำแหน่งที่คุณบอก รวมถึงโฟลเดอร์ภายในและไฟล์ทุกไฟล์  โดยให้คุณแน่ใจว่าตำแหน่งถูกต้อง
โดยคุณควรลองใช้ฟังก์ชัน <kbd>list_files()</kbd> ก่อนเพื่อพิสูจน์ว่ามีตำแหน่งนั้นจริง</p>

<code>
$this->ftp->delete_dir('/public_html/path/to/folder/');
</code>



<h2>$this->ftp->list_files()</h2>
<p>ยอมให้คุณรับรายการของไฟล์ทั้งหมดบนตำแหน่งที่คุณต้องการบนเซิร์ฟเวอร์ และคืนมาเป็น <dfn>อาเรย์</dfn>  โดยคุณต้องใส่ตำแหน่งของไดเรคทอรี่ที่คุณต้องการลงไป</p>

<code>
$list = $this->ftp->list_files('/public_html/');<br />
<br />
print_r($list);
</code>


<h2>$this->ftp->mirror()</h2>

<p>Recursively reads a local folder and everything it contains (including sub-folders) and creates a 
mirror via FTP based on it.  Whatever the directory structure of the original file path will be recreated on the server.
You must supply a source path and a destination path:</p>

<code>
$this->ftp->mirror('/path/to/myfolder/', '/public_html/myfolder/');
</code>



<h2>$this->ftp->mkdir()</h2>

<p>ยอมให้คุณสร้างไดเรคทอรี่บนเซิร์ฟเวอร์ของคุณ  โดยใส่ตำแหน่งลงไปพร้อมกับชื่อโฟลเดอร์ที่ต้องการและจบด้วย / (trailing slash)
คุณยังสามารถตั้งค่ายินยอมโฟลเดอร์ได้โดยส่งค่า <kbd>octal</kbd> ไปยังพารามิเตอ์รที่สอง (ใช้ได้แต่ต้องใช้ PHP 5 นะ)</p>

<code>
// สร้างโฟลเดอร์ชื่อ "bar"<br />
$this->ftp->mkdir('/public_html/foo/bar/', DIR_WRITE_MODE);
</code>


<h2>$this->ftp->chmod()</h2>

<p>ยอมให้คุณตั้งค่ายินยอมของไฟล์ (file permissions)  โดยใส่เส้นทางของไฟล์หรือโฟลเดอร์ลงไปตามด้วยค่ายินยอมที่ต้องการ</p>

<code>
// Chmod "bar" เป็น 777<br />
$this->ftp->chmod('/public_html/foo/bar/', DIR_WRITE_MODE);
</code>




<h2>$this->ftp->close();</h2>
<p>ปิดการเชื่อมต่อไปยังเซิร์ฟเวอร์ของคุณ  แนะนำให้คุณใช้มันเมื่อคุณเสร็จการอัพโหลดเสร็จแล้ว</p>








</div>
<!-- END CONTENT -->


<div id="footer">
<p>
หัวข้ออันก่อน:&nbsp;&nbsp;<a href="form_validation.html">Form Validation Class</a>
&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="#top">บนสุดของหน้า</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="../index.html">หน้าหลักคู่มือการใช้งาน</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
หัวข้อถัดไป:&nbsp;&nbsp;<a href="table.html">HTML Table Class</a>
</p>
<p>คู่มือการใช้งาน CodeIgniter นี้ได้ทำการคัดลอกและดัดแปลงจาก <a href="http://codeigniter.com/user_guide/">CodeIgniter User Guide</a></p><p>
<a href="http://codeigniter.com">CodeIgniter</a>
 ·  Copyright © 2006-2009  · 
<a href="http://ellislab.com/">Ellislab, Inc.</a>
</p>
</div>

</body>
</html>